Active element that displays an image that can be dragged with the mouse to control three parameters at the same time: one for the horizontal movements (x), one for the vertical movements (y), and one for a virtual 3rd dimension, controlled by the mouse wheel and '+' and '-' keys. The values of the parameters reflect the coordinates of the image in the widget:
This particular control supports the common widget attributes. It also has the attributes common to all param control widgets and param widgets, but with a 'x_', 'y_' or 'z_' prefix for each dimension. Note that only one dimension is mandatory (you do not need to connect all parameters, you can use for example the x and y controls only).
| Name | Value Type | Default Value | Description | Comment | V. | Exp. |
|---|---|---|---|---|---|---|
| Thumb images | ||||||
|
thumb_image |
valid image file path |
empty |
Path to the image to display for the thumb of the slider |
|
1.4.1 |
No |
|
thumb_image_mask |
valid image file path |
'thumb_image' value with '_mask' postfix |
Path to alpha mask for previous image |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No |
|
thumb_image_disabled |
valid image file path |
|
Path to the image to display for the thumb of the slider when the control is disabled |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No |
|
thumb_image_disabled_mask |
valid image file path |
|
Path to alpha mask for previous image |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No |
|
thumb_image_hover |
valid image file path |
|
Path to the image to display for the thumb of the slider when the mouse is over the control |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No |
|
thumb_image_hover_mask |
valid image file path |
|
Path to alpha mask for previous image |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No |
|
thumb_image_focus |
valid image file path |
|
Path to the image to display for the thumb of the slider when the control has focus |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No |
|
thumb_image_focus_mask |
valid image file path |
|
Path to alpha mask for previous image |
This value is optional since by default it is generated from 'thumb_image'. |
1.4.1 |
No |
| Other settings | ||||||
|
h_margin |
pixels |
0 |
horizontal margin of the control: used to define the horizontal range for the position of the thumb image. |
If not set, the thumb image will be cropped when the x parameter value reaches the limits of its range. |
1.4.1 |
No |
|
v_margin |
pixels |
0 |
vertical margin of the control: used to define the vertical range for the position of the thumb image. |
If not set, the thumb image will be cropped when the y parameter value reaches the limits of its range. |
1.4.1 |
No |
|
x_enabled |
true |
enable/disable movement for the horizontal coordinate of the joystick. |
|
1.4.4 |
1.4.4 |
|
|
y_enabled |
true |
enable/disable movement for the vertical coordinate of the joystick. |
|
1.4.4 |
1.4.4 |
|
|
z_enabled |
true |
enable/disable edit capability for the third coordinate of the joystick (available with mouse wheel or edit box). |
|
1.4.4 |
1.4.4 |
|